Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions That Modify Movie Properties / Working with Movie Time

SetMovieRate

The SetMovieRate function sets a movie's playback rate.

pascal void SetMovieRate (Movie theMovie, Fixed rate);

theMovie

Specifies the movie for this operation. Your application obtains this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).

rate

Specifies the new movie rate as a 32-bit, fixed-point number. Positive integers indicate forward rates and negative integers indicate reverse rates.

ERROR CODES

invalidMovie

-2010

This movie is corrupted or invalid

SEE ALSO

Your application can retrieve a movie's current playback rate by calling the GetMovieRate function, which is described in the next section. To play a movie at the movie's preferred rate from a position stored within the movie, you can use the StartMovie function (described on page 2-98).